home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 016 / tdsnap2.arc / TDSNAP.DOC next >
Encoding:
Text File  |  1987-03-26  |  6.1 KB  |  141 lines
  1.  
  2.                                Saxman Software
  3.                               Tools Disk Series
  4.  
  5.          Program:   TDSNAP
  6.          Version:   1.0  9/28/86
  7.          Purpose:   Write "snapshot" screen image to disk
  8.           Author:   Jim Standley
  9.                     Based on TSR code by Lane H. Ferris
  10.         Language:   TURBO Pascal
  11.         Requires:   DOS 2.0 or later
  12.                     128k
  13.       Overview
  14.  
  15.          TDSNAP is a memory resident program to write a "snapshot"  of
  16.          the current screen image to disk.  Once it is installed,  you
  17.          use Alt-F10 to  write the screen,  much the same  way you use
  18.          Shift-PrtSc to  print it.   You might  use TDSNAP  to capture
  19.          screen images for documentation, demos or tutorials.
  20.  
  21.          TDSNAP will  save character  mode screens  only, not graphics
  22.          mode.  If you run it  in graphics mode, the output  file will
  23.          not be usable.
  24.  
  25.       Using TDSNAP
  26.  
  27.          To install TDSNAP  as a memory  resident program, just  enter
  28.          TDSNAP.   You  can  optionally  specify  the file you want to
  29.          write.   The  file   specification  can  include   drive  and
  30.          directory.  The default file is "TDSNAP.TXT", written to  the
  31.          current directory.
  32.  
  33.          To invoke TDSNAP, press Alt-F10.  It saves the current screen
  34.          to disk.  The output file is standard ASCII format with CR/LF
  35.          at the end of each line.  Trailing spaces are removed.   Each
  36.          screen is written as 25 lines.  A line of hyphens is  written
  37.          before each screen.
  38.  
  39.          To  un-install  TDSNAP,  press  Ctrl-Home.  Un-install TDSNAP
  40.          only from  the DOS  prompt ">"  and only  if it  is the  last
  41.          memory resident program installed!!!!
  42.  
  43.       Memory Requirements:
  44.  
  45.          TDSNAP takes under 16k when memory resident.  If you have the
  46.          TURBO Pascal compiler, you might experiment with minimum  and
  47.          maximum free memory options.  I used 50 paragraphs for each.
  48.  
  49.       Comptability:
  50.          You're on your own.  I have tested it with CED and  Mansfield
  51.          Software's Personal Rexx resident.   If you find it  does not
  52.          run  with  any  other  TSR  programs,  let  me  know and I'll
  53.          document it.
  54.  
  55.       Note:
  56.  
  57.          The vast majority of the code in this program was written  by
  58.          Lane  H.  Ferris  and  can  be  found in the public domain as
  59.          "STAYRES3.ARC".  This  code does  all the  work of installing
  60.          the program, intercepting keystrokes, and un-installing.  The
  61.          few lines  required to  save the  screen to  disk are clearly
  62.          marked in the source file.
  63.  
  64.          The file "STAYRES.PAK" should be included with this  program.
  65.          It is  a compressed  version of  the essential  routines from
  66.          STAYRES.ARC.  It  can be  used as  the primary  ingredient in
  67.          cooking up new  TSR routines without  understanding a bit  of
  68.          it.  That's how TDSNAP was done, anyhow.
  69.  
  70.       Distribution:
  71.  
  72.          It is the  author's intention that  this program, source  and
  73.          object forms, be public domain.  It may be distributed freely
  74.          in any manner.  The author requests the following:
  75.  
  76.             1 - Do not charge for distribution of this program, beyond
  77.                 the cost of reproduction & mailing.
  78.             2 - Distribute this documentation with the program.
  79.             3 - Leave the author's name & address in the document.
  80.             4 - If you modify it, please take credit for your changes.
  81.                 I can't answer questions about unknown mods.
  82.  
  83.          If you want to promote user-distributed software and feel the
  84.          program is useful enough to be worth $15.00, the contribution
  85.          will certainly  be appreciated.   It will  also get  you on a
  86.          mailing  list  for  future  versions  and  other   utilities.
  87.          Include a  diskette and  self-addressed mailer  if you'd like
  88.          the source code.
  89.  
  90.       Author:
  91.          Jim Standley
  92.          Saxman Software
  93.          2350 Winstead Circle
  94.          Wichita, Ks  67226
  95.          316-688-0235  18:00-22:00  CST
  96.  
  97.       Revision Log:
  98.  
  99.          09/28/86 - First version, Standley
  100.         TDSNAP modified into TDSNAP2 by
  101.  
  102.           Logic Development Corporation and HEL Custom Software
  103.           127 Gaither Drive Suite F
  104.           Mt. Laurel, New Jersey 08054-1707
  105.           (609) 778-9077 or 234-3800
  106.  
  107.          This version is invoked as
  108.           TDSNAP2               - output to TDSNAP.TXT
  109.           TDSNAP2 filename.ext  - output to filename.ext
  110.           TDSNAP2 filename      - output to filename.nnn
  111.                                 where nnn increments each frame-
  112.                                 in effect creating individual
  113.                                 screen "slides"
  114.  
  115.          The last two invokations can be accompanied by either:
  116.            /G to include graphics
  117.            /C to include graphics but convert box characters
  118.                to acceptable WordStar characters
  119.            If neither switch is present, all graphic characters
  120.             are suppressed (converted to spaces).
  121.  
  122.          The UserInt was also changed to avoid a local conflict.
  123.          The Hot key was modified to <CTRL> F10.
  124.  
  125.           As professional software developers we were constantly
  126.        looking for an easier method to document our business software.
  127.        We tried a number of screen capture programs and looked at
  128.        TDSNAP in January.  Although TDSNAP offered the best function
  129.        for our type of work we needed a couple of additional features
  130.        to satisy all of our needs.  TDSNAP2 is our answer to the
  131.        ultimate screen capture program.  We have included the modified
  132.        source code for you PASCAL hackers.  Note our implementation of
  133.        the character translation table for graphics conversion.  Our
  134.        thanks to Jim Standley for the original concept and program. We
  135.        hope Jim and the rest of you like our additions.
  136.  
  137.        Gerry Lewis and Howard Lubert
  138.  
  139.        P.S.  All contributions should be directed to Jim
  140.        Standley.
  141.